03 November 2026

UCAS field mappings

The following tables describe how the UCAS column details are mapped onto EBS tables and columns:

Important.Where more than one field is listed, it is the first one in the list that is populated, unless otherwise stated.

UCAS applicant details

Note that the UCAS HE Incoming data overwrites EBS data institution setting determines which value EBS uses when both UCAS and EBS contain data for the same field.

  • If the setting is enabled, EBS uses the UCAS value.

  • If the setting is disabled, EBS keeps the existing EBS value.

  • A blank value never clears existing data. If the preferred source is blank for a field, EBS uses the value from the other source.

  • When the UCAS import finds an applicant who does not already exist in EBS, it creates a person record using the UCAS data.

UCAS fields that are not listed here remain in the UCAS staging tables and are not copied to EBS.

The table UCAS applicant details (UCAS_APPLICANT_DETAILS) describes the mappings between UCAS and EBS.

UCAS applicant details (UCAS_APPLICANT_DETAILS)
UCAS column EBS table/column Notes

Surname

People.surname

None

DateofBirth

People.date_of_birth

Blank if outside institution settings for minimum and maximum age.

Firstname

People.forename

People.middle_names

Updated in 4.44 to split into forename and middle names.

Title

People.title

Matched to a Title reference data value, unmatched titles are left blank.

Gender

People.sex

UCAS sex reference data lookup.

NationalInsuranceNumber

People.ni_number

None

MobilePhoneNo

People.mobile_phone_number

None

NominatedName

People.fes_next_of_kin

None

NominatedRelationship

People.fes_nok_cont_rel

None

DateEnteredUk

People.date_uk_entry

Added in 4.45.

EmailAddress

People.personal_email

None

countryOfBirthCode

People.place_of_birth

UCAS nationality reference data code lookup.

preferredFirstname

People.known_as

People.preferred_first_name

Added in 4.45.

uniqueLearnerNumber

People.unique_learn_no

None

personalID

People_ilr.ucasperid

None

nationalityCode

People.Nationality

UCAS nationality reference data code lookup, added in 4.44.

None

Addresses.address_type

UCAS HE institution setting > UCAS HE EBS Address Type.

None

Addresses.start_date

Import date.

None

Addresses.owner_type

Hard-coded to P.

Address1

Addresses.address_line_1

None

Address2

Addresses.address_line_2

None

Address3

Addresses.address_line_3

None

Address4

Addresses.address_line_4

None

Postcode

Addresses.uk_post_code_pt1

Addresses.uk_post_code_pt2

Postcode is standardised before it is stored, and blanked if in an invalid format.

UCAS applicant qualifications

The table UCAS applicant qualifications (UCAS_APPLICANT_QUALIFICATIONS) describes the mappings between UCAS and EBS.

UCAS applicant qualifications (UCAS_APPLICANT_QUALIFICATIONS)
UCAS column EBS table/column Notes

None

Attainments.atype_attainment_type_code

UCAS HE institution setting > UCAS HE Qualification on Entry code.

subjectOrCourse

Attainments.description

Attainment description is levelcode – subjectOrCourse.

levelCode

Attainments.description

Attainment description is levelcode – subjectOrCourse.

entrydateyear

Attainments.fes_year_achieved

If resultOrClass is populated. Defaults to current year if not set.

resultOrClass

Attainments.grade

None

predictedGrades

Attainments.fes_predicted_grade

None

UCAS applicant choices

The table UCAS applicant choices (UCAS_APPLICANT_CHOICES) describes the mappings between UCAS and EBS.

UCAS applicant choices (UCAS_APPLICANT_CHOICES)
UCAS column EBS table/column Notes

None

People_units.unit_type

Hard-coded to A.

None

People_units.progress_code

Existing applications are only updated if the UCAS HE institution setting, UCAS HE Allow UCAS to update existing applications, is set to Yes.

The progress code is not changed if the existing progress code is included in the UCAS progress code exclusions reference data.

  1. If the applicant’s choices were withdrawn, cancelled, substituted, or replaced with a newer choice, use the corresponding withdrawn, cancelled, substituted or previous progress code institution setting.

  2. Otherwise, map the UCAS Action:Decision:Reply combination by using the UCAS action:decision:reply reference data.

  3. If no mapping is available, use the UCAS HE default application code institution setting. If this setting is blank, use the Default application progress code institution setting.

None

People_units.progress_date

Import date.

None

People_units.who_to_pay

Applications institution setting > Who to pay.

None

People_units.record_date

Import date.

courseCode

None

Used to find matching EBS UIO, pointOfEntry included in matching from 4.46.

yearOfEntry

None

Used to find matching EBS UIO, pointOfEntry included in matching from 4.46.

pointOfEntry

None

Used to find matching EBS UIO, pointOfEntry included in matching from 4.46.

MonthEntry

None

Optionally used in course matching from 4.47 based on the UCAS HE institution setting, UCAS HE Course matching uses Month of Entry.

campus

None

UCAS HE institution setting, UCAS HE Campus mapping preference. If blank, not used. Also, UCAS campus reference data.

criminalRecordDeclaration

None

Used to indicate whether an applicant has declared a criminal record, added in 4.48.

UCAS applicant background

The table UCAS applicant background (UCAS_APPLICANT_BACKGROUND) describes the mappings between UCAS and EBS.

UCAS applicant background (UCAS_APPLICANT_BACKGROUND)
UCAS column EBS table/column Notes

ethnicCode

People.Ethnicity

Reference data lookup on Ethnicity, added in 4.44.

UCAS applicant living with conditions

The table UCAS applicant living with conditions (UCAS_APP_LIVING_WITH CONDITION) describes the mappings between UCAS and EBS.

UCAS applicant living with conditions (UCAS_APP_LIVING_WITH CONDITION)
UCAS column EBS table/column Notes

Code

Disabilities.Disability_type

Reference data lookup onUCAS disability, added in 4.48.

Codes

Disabilities.Disability_type

Comma separated list and will be used from 2027 application cycle, added in 4.51.

AdditionalNeeds

Notes.Notes

Note linked to the disability record.

None

Disabilities.Long_Description

Set as See notes for further information, if AdditionalNeeds is populated.

LastUpdated

Disabilities.Start_date

None